<?php

/**
 * Maikuro Framework
 *
 * LICENSE:
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * The license is bundled with this package in the file LICENSE.txt.
 * You may also obtain a copy of the License at this URL:
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 * @copyright  Copyright (c) 2010, Jonathan Hedrén
 * @author     Jonathan Hedrén <jonathan.hedren@gmail.com>
 * @license    http://www.apache.org/licenses/LICENSE-2.0 Apache License, Version 2.0
 */

/**
 * @see AbstractPdoDbHandler
 */
require_once 'AbstractPdoDbHandler.php';

/**
 * @see MysqlPdoDbTransaction
 */
require_once 'MysqlPdoDbTransaction.php';

/**
 * MySQL PDO database wrapper.
 */
class MysqlPdoDbHandler extends AbstractPdoDbHandler
{
    /**
     * Constructor.
     *
     * @param string $user
     * @param string $password
     * @param string $database
     * @param string $host
     * @return MysqlPdoDbHandler
     */
    public function __construct($user, $password, $database, $host = 'localhost')
    {
        try {
            $this->connection = new PDO(
                'mysql:host=' . $host . ';dbname=' . $database,
                $user,
                $password
            );
            $this->connection->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
        } catch (PDOException $e) {
            throw new Exception('Failed to get database handle: ' . $e->getMessage());
        }
        return $this;
    }

    /**
     * Creates a database transaction.
     *
     * @return MysqlPdoDbTransaction 
     */
    public function createTransaction()
    {
        return new MysqlPdoDbTransaction($this->connection);
    }
}
